home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / TN074.ZIP;1 / TN074.TXT
Encoding:
Text File  |  1993-04-14  |  12.0 KB  |  369 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.        ATI Technologies Inc.,
  8.  
  9.        3761 Victoria Park Avenue,
  10.        Scarborough, Ontario, M1W 3S2
  11.  
  12.        Tel:(416) 756-0718  Fax:(416) 756-0720
  13.        Telex:06-966640 (ATI TOR)
  14.  
  15.                                                                                                  Technology you can Trust
  16.  
  17.  
  18.           Customer Support Department
  19.           Technical  Note  No.  74  -  Mach32  Programmer's  Reference  Manual
  20.           Information
  21.  
  22.                   Programmer's Reference Manuals for Mach32 Accelerators
  23.  
  24.           CONTENTS
  25.  
  26.                INTRODUCTION
  27.                AVAILABLE MATERIALS
  28.                WHAT IS NOT AVAILABLE
  29.                PLEASE READ BEFORE ORDERING
  30.                DISCLAIMER
  31.                ORDERING
  32.  
  33.           INTRODUCTION
  34.  
  35.           Thank you for your interest in obtaining programming documentation for
  36.           ATI products  based on  the ATI Mach32  graphics accelerator  chipset.
  37.           Products  using this chipset include  the Graphics Ultra Pro, Graphics
  38.           Ultra  +  and various  products  that  ATI manufactures  for  computer
  39.           vendors.  This document  describes  the Mach32  Programmer's Kit,  its
  40.           purpose   and how to obtain the  kit. It also describes what materials
  41.           are NOT  available  and the  terms  and  conditions by  which  we  are
  42.           offering the kit.
  43.  
  44.           ATI  has  not  publicly  announced  the  availability  of  the  Mach32
  45.           Programmer's Kit because the material  are not complete at this  time.
  46.           However, what we  are offering today  may be  sufficient to meet  some
  47.           programmers' requirements. Please read this  document carefully before
  48.           placing an order.
  49.            
  50.           AVAILABLE MATERIALS
  51.  
  52.           1)   Programmer's Guide to the Mach32 Registers
  53.  
  54.                     A  350  page   register  specification  detailing  all   252
  55.                     registers  including   all  VGA,   8514/a  and  ATI   Mach-8
  56.                     compatible registers. Subjects  include the Bresenham vector
  57.                     & polygon  drawing engine,  the Direct Draw  drawing engine,
  58.                     the BitBLT  engine, the hardware cursor,  the pixel transfer
  59.                     ALU and CRT controller.
  60.  
  61.                     The register specification  is a  reference for  programmers
  62.                     with  experience  writing  device drivers  for  graphics co-
  63.                     processors at the register level.
  64.  
  65.  
  66.  
  67.  
  68.           2)   Programmer's Guide to the Mach32 Adapter Interface
  69.  
  70.                     The Turbo AI is  a high level interface compatible  with the
  71.                     IBM Adapter Interface Specification.  It is implemented as a
  72.                     TSR which  provides a set  of callable high  level functions
  73.                     for mode  selection  and initialization,  primitive  drawing
  74.                     functions,  color  palette manipulation,  font  handling and
  75.                     other  useful  functions. Modes  supported  are  640X480 and
  76.                     1024X768  /256 colors  only.  Other  resolutions  and  color
  77.                     depths  supported  by  the   hardware  are  outside  the  AI
  78.                     Specification.
  79.  
  80.                     ATI recommends the AI to those programmers who would like to
  81.                     take  advantage  of  hardware  assisted  drawing  capability
  82.                     without  a  heavy  investment  in  development  time  or  if
  83.                     register level device driver expertise is not available.
  84.  
  85.           3)   Mach32 Application Notes
  86.  
  87.                     AN0001 - Accessing Video RAM via the Linear or Banked Memory
  88.                     Aperture
  89.  
  90.                          This discusses  techniques for accessing the video RAM,
  91.                          the Linear  Aperture and  the VGA Aperture.  The Linear
  92.                          Aperture  make use  of  a  relocatable Extended  memory
  93.                          address. It  offers true  32 bit linear  addressing for
  94.                          enhanced  performance for protected  mode software. The
  95.                          VGA aperture  allows the  video memory to  be addressed
  96.                          like a SuperVGA card. It provides access to up to 2M of
  97.                          RAM via banking for real mode software.
  98.  
  99.                     AN0002 - Setting screen modes using the Adapter ROM
  100.  
  101.                          This discusses the use of internal  ROM routines to set
  102.                          up and initialize all supported resolution/color modes.
  103.  
  104.  
  105.                     AN0003 - Detection of a Mach32 adapter
  106.  
  107.                          This  covers identification  of  Mach32 products  via a
  108.                          combination  of  the  ATI ROM  signature  and  register
  109.                          read/writes.
  110.  
  111.                     AN0006 - Drawing Solid or Patterned Lines with Hardware
  112.  
  113.                          -  This discusses the use of the ATI Direct Draw Engine
  114.                          for high speed vector drawing.
  115.  
  116.           4)   VESA Interface Disk
  117.  
  118.                     A  3.5" HD diskette containing a TSR which supports the VESA
  119.                     SuperVGA  BIOS  Extension   standard  on  Mach32   products.
  120.                     Resolutions  supported up  to  1024X768 in  16, 256  and 32K
  121.                     colors. A utility which can display the supported video mode
  122.                     is supplied  along with an demonstration  program which uses
  123.  
  124.                                            2                      ACCESS : All
  125.  
  126.  
  127.  
  128.  
  129.                     VESA mode 116h (1024X768/32K colour).
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.                                            3                      ACCESS : All
  186.  
  187.  
  188.  
  189.  
  190.  
  191.           WHAT IS NOT AVAILABLE
  192.            
  193.                ATI  intends to  offer  additional application  notes on  polygon
  194.                drawing,  BitBLT  engine  operation,  hardware  cursor  and  text
  195.                generation.  A set of  sample code segments  in MS C  and MASM is
  196.                also planned. These  items are planned for release by  the end of
  197.                first quarter, 1993.
  198.  
  199.                ATI does NOT plan  to offer a linkable graphics  function library
  200.                or high level interface for our products. However, ATI encourages
  201.                and assists developers of commercial graphics library packages to
  202.                support our products. None of these graphics library vendors have
  203.                yet  announced a version which supports  the Mach32. If you are a
  204.                current  user   of  a   graphics  library,  please   contact  the
  205.                manufacturer  for  information about  if  and when  they  plan to
  206.                release a version which supports ATI Mach32 products. 
  207.  
  208.           PLEASE READ BEFORE ORDERING 
  209.  
  210.           The  Mach32 is a uniquely flexible device which is compatible with IBM
  211.           VGA, 8515/a and earlier  ATI SuperVGA and Accelerator products.  It is
  212.           entirely possible to  implement software  which uses the  Mach32 as  a
  213.           SuperVGA, as a linear frame buffer or as an accelerator card.  
  214.  
  215.           Application  notes 1,  2 &  3 contain  sufficient information  for the
  216.           experienced  programmer to use  all high resolution  and/or high color
  217.           modes of the Mach32 as a SuperVGA  or linear frame buffer card. If you
  218.           are not familiar with Super-VGA programming techniques, ATI offers the
  219.           VGAWONDER Programmer's Reference Manual. 
  220.  
  221.           The Mach32  also contains  a high  performance  graphics engine.  This
  222.           provides hardware assist for  vector/polygon drawing, screen to screen
  223.           BitBLT, hardware  cursor and several other  functions. Programming the
  224.           graphics  engine  is  much  different  and  more  difficult  than  any
  225.           conventional frame buffer card  (EGA, VGA..etc). Only programmers with
  226.           experience designing graphics primitive  functions and writing  device
  227.           drivers for programmable  peripheral devices on the  PC should attempt
  228.           to  access the  engine directly.  We would  recommend that  unless you
  229.           already have  experience with other accelerator cards,  such as 8514/a
  230.           or XGA,  or have source  code examples for  such cards that  you delay
  231.           ordering until our example code is released. Otherwise, ATI recommends
  232.           using the Adapter  Interface or  obtaining a graphics  library from  a
  233.           third party vendor. 
  234.  
  235.           All examples are  written in MS  C and MS  MASM. Familiarity with  the
  236.           syntax  and conventions of these  compilers is required.  ATI does not
  237.           support  other compilers and will not assist with conversion of sample
  238.           code to other compilers.
  239.  
  240.           ATI Customer Support will  assist with installation, configuration and
  241.           basic  information but will not be able to answer specific programming
  242.           questions.   
  243.  
  244.  
  245.  
  246.                                            4                      ACCESS : All
  247.  
  248.  
  249.  
  250.  
  251.  
  252.           DISCLAIMER
  253.  
  254.           Please  note that the materials within the Mach32 Programmer's Kit are
  255.           provided on  as "as is" basis  although every effort has  been make to
  256.           ensure that the documents in the kit are complete and accurate. 
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.                                            5                      ACCESS : All
  308.  
  309.  
  310.  
  311.  
  312.           ORDERING
  313.  
  314.           The  Mach32  Programmer's Kit  is now  available  for only  $US50 plus
  315.           delivery  charge. Orders  can be  placed by  filling out  the attached
  316.           order form  and FAXing or  mailing it to  ATI Customer Support  at the
  317.           following address:
  318.  
  319.                     ATI Technologies Inc.
  320.                     Customer Support Department
  321.                     3761 Victoria Park Avenue
  322.                     Scarborough, Ontario
  323.                     Canada    M1W 3S2
  324.  
  325.                     phone     +(416) 756-0711
  326.                     fax  +(416) 756-0720
  327.  
  328.           Payment  will  only  be accepted  with  a  valid  VISA, MasterCard  or
  329.           American Express number. Customer  Support will ship your programmer's
  330.           kit as soon as your credit card charge is approved.  Please allow 7-10
  331.           days  for ground delivery. Allow  more time for  mail delivery outside
  332.           North America. Additional shipping charges  may be applied for  faster
  333.           delivery methods (see below). No refunds will be offered.
  334.  
  335.           Ship to:
  336.  
  337.           Name:     ________________________________________________
  338.           Company:  ________________________________________________
  339.  
  340.           Address:  ________________________________________________
  341.                     ________________________________________________
  342.  
  343.           City:          ______________________   ZIP/code ________________
  344.           State/Prov     ______________________   Country  ________________
  345.  
  346.           Charge to:
  347.           Name of cardholder  ____________________________________       (please
  348.  
  349.           print)
  350.           ( VISA / MasterCard / AMEX ) # _______________________________
  351.  
  352.           expiry date    _____ / _____ / ____________
  353.  
  354.           Delivery by:   _____  Ground   Courier1    _____   Air  Courier2  _____
  355.           Overseas Courier3
  356.                1 $15, North America only      2 $US20, North America only
  357.                3  $US25,  All countries  outside  North  America,  no  overnight
  358.           delivery available
  359.  
  360.           I DECLARE THAT I HAVE READ AND UNDERSTOOD THIS DOCUMENT AND I AGREE TO
  361.           THE TERMS AND CONDITIONS CONTAINED WITHIN.
  362.  
  363.           signed:  ___________________________________ Dated:  _____ /  ______ /
  364.           ___________
  365.  
  366.  
  367.  
  368.                                            6                      ACCESS : All
  369.